home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / pcbt098.zip / PCBTIC.DOC < prev    next >
Text File  |  1993-01-21  |  16KB  |  381 lines
  1.   PCBTIC ver 1.00             (c) Copyright XON/XOFF Computer Solutions, 1992
  2.                                                  XON/XOFF Information Service
  3.                                                         Robert & Joel Lechter
  4.  
  5.   ╒═════════════════════════════════════════════════════════════════════════╕
  6.   │                                                                         │
  7.   │                                                                         │
  8.   │                         B E T A   V E R S I O N                         │
  9.   │                                                                         │
  10.   │                                                                         │
  11.   ╘═════════════════════════════════════════════════════════════════════════╛
  12.  
  13. ■ Minimum Requirements:
  14.  
  15.       · A 286 or better computer.  (A version which works on an XT is
  16.         available upon request.)
  17.  
  18.       · 220 KB conventional RAM.
  19.  
  20.       · FrontDoor or BinkleyTerm.  Other mailers will be supported as time
  21.         allows.  Contact the author for specific requests.
  22.  
  23.  
  24. ■ What is PCBTIC?
  25.  
  26.         PCBTIC is the ultimate .TIC file processor.
  27.  
  28.         PCBTIC is a program which will process incoming TIC files, and import
  29.         them into the PCBoard DIR Text File format (PCBoard file
  30.         descriptions).
  31.  
  32.         Originally it was intended for our personal use in importing TIC
  33.         files to our PCBoard BBS.  As our needs grew, so did the program.
  34.         When we were assigned hub status, we had to begin exporting files, so
  35.         the program was recoded.  Then we had to start supporting points, so
  36.         more recoding.  Little by little, the program has evolved into the
  37.         little monster that it is, with almost 6000 lines of code.
  38.  
  39.  
  40. ■ What is a TIC file?
  41.  
  42.         A TIC file (named TKxxxxxx.TIC) is a file which accompanies
  43.         officially distributed File Distribution Network files.  You probably
  44.         get a couple TIC's each week with your NODEDIFF and the Fido news
  45.         (FNEWSxxxx), but never really knew what to do with them.  We USED to
  46.         delete them, but no more!
  47.  
  48.         TIC files contain a bunch of information about the attached file,
  49.         including its path from the author to you, the description, and a CRC.
  50.  
  51.  
  52. ■ Who needs it?
  53.  
  54.         With the growing number of PCBoard BBS's which are becoming Fido
  55.         compatible (especially using FidoPCB), this is an essential program
  56.         to properly import incoming TIC files to the PCBoard DIR Text file
  57.         format.  The original program, TICK, does not properly import the
  58.         descriptions into the PCBoard format--in spite of the documentation--
  59.         and, in fact, severely corrupts the descriptions, such that PCBFILER
  60.         can't access them.
  61.  
  62.         I tried a number of other PCBoard TIC processors, and found their
  63.         abilities lacking; in previous versions of OTHER processors, files
  64.         were only able to be imported to one directory, or no real CRC
  65.         checking was done, or no redistribution of files was allowed.
  66.  
  67.  
  68. ■ Legal Stuff.
  69.  
  70.         We are currently running this program on our own multi-line PCBoard
  71.         (14.5a/10) BBS under LANtastic and it hasn't trashed anything, so I
  72.         guess it works.  In fact, we are a FidoNet hub (look for us in the
  73.         NODELIST!), so we regularly redistribute files.
  74.         
  75.         NOTE: PCBTIC does not yet support file/record locking.  This will be
  76.               available in a future release.
  77.  
  78.  
  79. ■ How can you contact the author?
  80.  
  81.         The easiest way you can send us a message, since you are a Fido
  82.         compatible system, is via NetMail at 1:167/159; you can address the
  83.         message to SysOp.
  84.  
  85.         We can also be reached on our own 24 hour BBS at (514) 683-6729
  86.         (USRobotics Dual Standard 14400) or by fax at (514) 685-1152 (7am -
  87.         9pm Eastern Time).
  88.  
  89.         Network addresses:
  90.                 FidoNet:                          1:167/159
  91.                 KESHERnet:                       18:716/201
  92.                 FrancoMedia:                    101:190/105
  93.                 NAnet:                             51/41/12
  94.                 EchoNet:                           51/40/52
  95.                 Internet:       Robert.Lechter@xonxoff.uucp
  96.         
  97.  
  98. ■ Why would you want to contact the author?
  99.  
  100.       · First and foremost to report a bug.
  101.       · To send us your comments about the program.
  102.       · You might want to offer suggestions for added features in future
  103.         releases.
  104.       · To get information on custom versions.
  105.  
  106.         I look forward to your input.
  107.  
  108.  
  109. ■ How do I set-up PCBTIC?
  110.  
  111.         The configuration file is quite straightforward.  There are two types
  112.         of area declarations.
  113.  
  114.         Example #1:
  115.  
  116.                 AREA NODEDIFF             <──── The area defined by the sender
  117.                  c:\files\dirfl1          <──── where the descriptions go.
  118.                  g:\pcb\fd\nodelist       <──── where the file actually goes.
  119.                  NODEDIFF                 <──── The password for this area
  120.                  FROM 1:167/159 HISPASS   <──── Straightforward, with password.
  121.                  TO 1:1/1 PASS1           <──── Straightforward, with password.
  122.                  TO 2:3/4.5 PASS2 NOTIC   <──── As above, but no TIC file will
  123.                                                 be made for this address.
  124.                  TO 2:3/4 PASS NOTIC CRASH
  125.                  TO 5:6/7 PASS HOLD
  126.                  TO 1:2/2 PASS NOTIC HOLD
  127.  
  128.  
  129.         The above example indicates that the files will be imported into
  130.         PCBoard, as well as possibly being echoed, if there is one (or more)
  131.         valid TO directive(s).
  132.  
  133.         Example #2:
  134.  
  135.                 AREA SOME_AREA
  136.                  passthru
  137.                  FROM ...
  138.                  TO   ...
  139.  
  140.         The above example indicates that the files in this area will NOT be
  141.         imported into PCBoard, but merely echoed to the destination sites.
  142.         Please note that if no TO addresses are listed, any incoming files in
  143.         a PASSTHRU area will be deleted.
  144.  
  145.  
  146.         There are a few other switches in the CFG file that are user
  147.         adjustable.
  148.  
  149.         REPLACE         Optionally deletes old version of new files.
  150.  
  151.         DUPECHECK       Enables checking for duplicates based on CRC's.
  152.  
  153.         CHANGEDATE      Optionally changes the date of the incoming files, or
  154.                         leave them as is.  It is recommended that this switch
  155.                         be left ON, since a (N)ew file scan will then work
  156.                         properly.
  157.  
  158.         CONFIG          The directory for your mailer.  PCBTIC will read that
  159.                         configuration file for more information.  This is to
  160.                         make your life simpler by reducing the size and
  161.                         complexity of this configuration file.
  162.  
  163.         TIME            Indicates how the program should handle the switch from
  164.                         standard to daylight time.  I have found the way that
  165.                         other programs implement this (the TZ environment
  166.                         variable) lacking, since it can't account for
  167.                         variances between countries.
  168.  
  169.                         Format:  TIME s, d, interval
  170.  
  171.                         where `s' indicates the number of hours to add to
  172.                               current system time to get UTC (GMT) during
  173.                               standard time (+5 for east coast of North
  174.                               America)
  175.  
  176.                               `d' indicates the number of hours to add during
  177.                               daylight savings time (+4 for east coast of N.A.)
  178.  
  179.                               `interval' indicates the time interval that
  180.                               savings time is in effect.  It can be an absolute
  181.                               date, such as `1 APR - 15 OCT' or a relative date,
  182.                               such as `2 SUN APR - 5 TUE OCT'.  This relative
  183.                               date indicates the second Sunday in April until
  184.                               the 5th (or last) Tuesday in October.
  185.  
  186.                         If your system time is UTC, then you can simply use
  187.                         TIME UTC (or TIME GMT).
  188.  
  189.  
  190. ■ Command line options:
  191.  
  192.         /debug:n        Logs more information for debugging purposes.  Be
  193.                         careful!  The larger the number, the more info gets
  194.                         placed into your log file.
  195.  
  196.                         WARNING: Level 9 makes HUGE log files, and has been
  197.                                  included for special debugging.
  198.  
  199.         /corrupt        Forces corrupt files to be imported.
  200.  
  201.  
  202. ■ Is PCBTIC network aware?
  203.  
  204.         Not yet.  We are using it on a network, but haven't yet tested it
  205.         with file locking and sharing.
  206.  
  207.  
  208. ■ Why should I register PCBTIC?
  209.  
  210.         If you find this program useful and time-saving, you should register
  211.         the program.  This will ensure that we can properly support it.
  212.  
  213.         Registration will also allow more than three areas to function.
  214.  
  215.         Additionally, some companion programs will be released which will
  216.         work alongside PCBTIC.  These programs will only work with the
  217.         registered version of PCBTIC.
  218.  
  219.  
  220. ■ How do I register PCBTIC?
  221.  
  222.         Please see the PCBTIC.REG file (registartion form) and PCBTIC.VER
  223.         (version information) enclosed in this archive.
  224.  
  225.  
  226. ■ How much does registration cost?
  227.  
  228.         A new fee structure has been announced.
  229.  
  230.         The registration fee is 15$.  This will enable all the features of the
  231.         program for 25 file areas (60 cents per area).
  232.  
  233.         For more areas, please see the PCBTIC.VER file.
  234.  
  235.  
  236. ■ Why is there no upper limit on the registration fee?
  237.  
  238.         We have been asked this question quite a few times, and have pondered
  239.         whether or not to place a ceiling on the fees.  Our conclusion was
  240.         not to limit the fee.  After consulting with a number of SysOps, we
  241.         determined that 25 areas was reasonable.  Once this number of file
  242.         areas is reached, that system is probably a commercial system.
  243.  
  244.         Since PCBoard BBS's are often larger (i.e. more users, and more phone
  245.         lines) than other BBS programs, it is was not deemed fair to charge
  246.         an amateur system and a commercial system the same amount for the
  247.         program.
  248.  
  249.         If you are an amateur system which does not charge its users, and
  250.         would really like to use PCBTIC, but the number of areas you carry
  251.         would price it out of your range, I suggest asking you users (or
  252.         those that download files) for a small (i.e. 2$) donation to pay for
  253.         this program and help offset your phone, and electric bills.
  254.         
  255.  
  256. ■ What does the REGISTERED version do that the unregistered doesn't?
  257.  
  258.   Areas supported:
  259.           unr:   a maximum of three areas.
  260.           reg:   unlimited (actually limited by KEY file)
  261.  
  262.    Nuisances:
  263.           unr:  Delay upon program completion.
  264.           reg:  No delay.
  265.  
  266.  
  267. ■ What will future 1.xx releases do?
  268.  
  269.       · Well, network awareness is on the agenda, as well as support for
  270.         other front-end mailers.
  271.       · The .BAT file implementation is also scheduled for an overhaul.
  272.       · Detect of self-extracting archives.
  273.  
  274.  
  275. ■ What about future versions of PCBTIC?
  276.  
  277.         No details are available yet, but some companion programs are in the
  278.         works.
  279.  
  280.  
  281. ■ Hints for proper integration of PCBTIC, your mailer, and your BBS.
  282.  
  283.         Our mailer (FrontDoor) is set to exit after any file is received.  Here
  284.         is the .BAT file segment that we use in order to integrate PCBTIC into
  285.         our BBS.
  286.  
  287.                                        .
  288.                                        .
  289.                                        .
  290.         if not exist g:\frontdor\inbound\*.TIC goto NoTICK
  291.         usernet c:\pcb\main\usernet.xxx 1 Y * * "Processing new files"
  292.         f:
  293.         cd \pcbtic
  294.  
  295.         rem     * While the next two lines are not needed, we include them,
  296.         rem       just in case the PCBTIC.EXE program is not found.  It will
  297.         rem       eliminate AFTER.BAT being run each time, and it will
  298.         rem       eliminate the report file being inserted each time.
  299.  
  300.         if exist after.bat del after.bat
  301.         if exist pcbtic.rpt del pcbtic.rpt
  302.  
  303.         pcbtic
  304.  
  305.         rem Update headers and check for viruses.
  306.         if exist after.bat call after
  307.  
  308.         rem     * Import new files report (This is all one command)
  309.         rem     * Robert Vostrey's TXT2MSG program is required.
  310.  
  311.         if exist pcbtic.rpt c:\txt2msg\txt2msg C:\PCB\MAIN\MSG -p -tALL
  312.                 -fPCBTIC -sNEW_FILES_IN_CONF_2 pcbtic.rpt
  313.  
  314.         rem Update PCBoard's index files.
  315.         call c:\pcb\refresh.bat
  316.                                        .
  317.                                        .
  318.                                        .
  319.  
  320.  
  321.  
  322. ■ ERRORLEVELS
  323.  
  324.         When PCBTIC exits, it will set the ERRORLEVEL which can be checked
  325.         by your .BAT file.
  326.  
  327.           1 - Unable to open CFG file.
  328.           2 - Error message handler variable is out of bounds.
  329.           5 - Can't find inbound directory (as reported by mailer).
  330.           6 - Inbound directory is not a directory.
  331.           7 - Can't find outbound directory (as reported by mailer).
  332.           8 - Outbound directory is not a directory.
  333.           9 - Can't find MAIL directory (where MSG files go).
  334.          10 - MAIL directory is not a directory.
  335.          11 - Corrupt KEY file.
  336.          12 - Corrupt KEY file.
  337.          13 - Corrupt KEY file.
  338.          14 - Corrupt KEY file.
  339.          15 - KEY file is outdated.
  340.          16 - Unknown mailer type.
  341.          17 - Can't find mailer's directory.
  342.          18 - mailer's directory is not a directory.
  343.          20 - Can't find mailer's directory.
  344.          21 - Error in SETUP.FD file (FrontDoor only).
  345.          22 - No CONFIG entry in PCBTIC.CFG.
  346.          30 - Can't create work directory.
  347.          31 - Can't create work directory.
  348.          32 - Error in TIME directive
  349.          33 - No INBOUND directories in configuration file.
  350.          34 - Error in your address (in mailer configuration)
  351.  
  352.  
  353. ■ Echoing files
  354.  
  355.         PCBTIC can redistribute files to other sites.  This allows PCBoard
  356.         BBS's to  act as Fido hubs (as we are), or even as File Distibution
  357.         Network Systems.
  358.  
  359.  
  360. ■ Revision History
  361.  
  362.         Please see the PCBTIC.HST file.
  363.  
  364.  
  365. ■ Final Notes
  366.  
  367.         You are encouraged to send this file to other SysOps operating PCBoard
  368.         and front-end mailers.  If you do, please include the entire archive in
  369.         its original format (-AV intact, please), and do not change the
  370.         distribution name from the original name.
  371.  
  372.         We are interested in as much feedback as possible, so please drop us a
  373.         line.
  374.  
  375.         We freqent the FidoNet PCBNET conference, the FidoPCB support
  376.         conference, and the PCBoard Support conference.  Of course, NetMail is
  377.         always welcome!
  378.  
  379.                                         Robert & Joel Lechter
  380.                                         FidoNet 1:167/159
  381.